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Abstract 

This is an introductory manual describing the display-oriented text editor E that is 
available on the Stanford A.I. Laboratory PDP-10 computer. The present manual is 
intended to be used as an aid for the beginner as well as for experienced computer users 
who either are unfamiliar with the E editor or use it infrequently. Reference is made to 
the two on-line manuals that help the beginner to get started and that provide a complete 
description of 'the editor for the experienced user. 

E is commonly used for writing computer programs and for preparing reports and 
memoranda. It is not a document editor, although it docs provide some facilities for 
getting a document into a pleasing format. 'The primary emphasis is that of speed, both 
in terms of the number of key strokes required of the user and in terms of the demands 
made on the computer system. At the same time, E is easy to learn and it offers a large 
range of facilities that are not available on many editors. 
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Preface 

This manual is a condensation of the on-line e.als[UP.D0C] manual and it is not a substitute for the 
complete documentation therein presented. The aim is to provide the user with a hard copy 
manual that tells him what can be done by E and where he can find die more complete explanation 
in the on-line manual. 

So many people have, by now, contributed to this editor that it is difficult to ascribe proper credit. 
Dan Swinchart, wrote the original TV editor and created the original version of eteacii. Others 
who have worked extensively on E include Fred Wright, Brian Harvey, Arthur Samuel and Martin 
Frost. The present manual was written by Arthur Samuel. 

Special Symbols 

Special symbols are used in this manual (also in E.ALS[UP,DOC] and in ETEACH): 

The arrow line refers to one line of text that is indicated on the DataDisc terminals by the 
presence of an arrow to the left of this line, and on the DataMedia terminals by an underscore 
beneath the first character. 

The CURSOR refers to the underscore under one character of the arrow line when in the line-edit 
mode. On the DataMedia terminals this cursor is distinguished from the cursor pointing to the 
arrow line by the fact that the entire line is brightened when in the line-edit mode. 

The keys labeled "control" on the DataDisc terminal and "CTRL" on the DataMedia terminal are 
quite different and care must be taken not to confuse them. 

On the DataDisc 

a means hold the CONTROL key down while typing the next character. 

/? means hold the met A key down while typing the next character. 

ap means hold both the CONTROL and the meta keys down while typing. 

<8> means hold either the control key or both control and meta keys with the next character. 

On the DataMedia 

a means hold the edit key down while typing the next character. 

/? means make an extra key stroke ahead of the character holding edit key and typing the null 

key. 

aft means make an extra key stroke ahead of the character, holding edit key and typing the null 

key, then keep the edit key down while typing the next character. 

® means do either as explained for a or as explained for aft (but not as for ft). 

Some of the characters on the DataDisc keyboard are missing from the DataMedia and require the 
use of the CTRL key. Sec the Appendix for full details. 
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1. Introduction 



E is a display-oriented text editor available on the Stanford A.I. Laboratory PDP-10 computer. It is 
not a document editor, although it does provide some facilities for getting a document into a 
pleasing format. It is regularly used by many people for writing programs and for the preparation 
of the texts that are subsequently used as inputs to more elaborate document editors. The primary 
emphasis is that of speed, both in terms of the number of key strokes required of the user and in 
terms of the demands made on the computer system. At the same time, E is easy to learn and it 
offers a large range of facilities that are not available on many editors. E is an in-place editor and 
version copies are not made unless the user specifically arranges for this to be done. 

This is an introductory manual, intended to be used as an aid for the beginner as well as for 
experienced computer users who either are unfamiliar with the E editor or use it infrequently. This 
manual is not intended as a replacement for the on-line E manuals but rather as a concise statement 
of the capabilities of the E editor that can be used to see what facilities E offers for handling 
specific tasks. In the interests of simplicity, most of the explanations will be in terms of the use of 
the DataDisc terminals with only occasional reference to DataMedia terminals. 

Two on-line E documents are available. 

f-tkach is an teaching program that guides the beginner, step by step, into the use of E. The only 
initial information needed is that of how to log on the system. Having logged on, the user simply 
types help ftkach followed by a carriage return. The program then instructs the user, step by 
step. Even the experienced computer user may profit from a brief session with this program. 

The second on-line document, e.ai.S[UP.doc], is an all-inclusive E manual. It can be referenced by 
typing i-t?<C'R> to the system or by typing <control>?, if currently editing some other file. 
Frequent references will be made to this on-line manual in the present publication. The directory 
on page 1 and the index of all commands on page 3 of this on-line document will be found most 
useful in locating additional information. 

2. Basic Features 

2.1 Paging 

A typical E file is made up of a number of separate pages of differing lengths, where each page is 
restricted to some logically related sub-section of the total text. It is not necessary to adjust the 
page size to that desired for the finished document as there are a number of commands that allow 
one to break pages into smaller pages and to combine several small pages into one large page. It is 
also possible to bring several contiguous pages into core together when this is desirable. H functions 
best if the si/.c of the individual pages is limited to perhaps 200 or 300 lines of text, although \i is 
•quite capable of handling very large pages indeed, but only at a substantial cost in terms of speed 
and of the load on the system. 

Normally, only a single page is kept in core while it is being edited and changes in this page are not 
copied onto the disk unless requested or until one moves to another page or leaves the editor. This 
greatly decreases the demands on the system. It allows one to undo all of the recent corrections to 
the page being edited by a single command, if desired. It lias the unfortunate effect that an entire 
page of recent corrections can be lost if the system should go down before the user lias issued a 
save command or has done so indirectly by going to another page or another file or by exiting from 
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E. Because of paging, there is no practical limit to the size of the files that can be edited by E, 
other than the limit imposed by the computer system itself. 

E provides special facilities for moving from page to page within any one file and for moving 
between files, with the information as to the recently visited files, including the page and line 
locations, kept in an internal stack so that one can return to these locations with a minimum of 
effort. One can move or copy text from any file so visited to other locations in this file or to any 
location in any other file. 

2.2 File Formatting 

E expects the file that is being edited to be formatted internally in a particular way. Please note 
that this file formatting has to do with the way that the file is stored in the computer and it has 
nothing to do with the text formatting per sc. A. file created by E will, of course, be automatically 
formatted. Should the user attempt to edit an unformatted file, F will prompt with the options that 
are available. While it is possible to use E with unformatted files, the user is strongly urged to 
allow files that occupy more than one page to be formatted. An unformatted copy can be made, if 
necessary, after editing has been completed. 

Formatted files have a special first page mat is created by E and automatically kept up to date as 
changes are made to the text. This directory page tells E where each page starts in the disk copy of 
the file, thus simplifying the work required for E to write or read a page of text. This first page 
also contains the text of the first line of each normal page. This text can be searched by special 
commands to locate the page on which some desired information may be found. There are special 
commands that will cause E to search through an entire page and list certain types of information 
on a newly generated first line, to aid in tliis process. For texts where these special commands are 
not applicable, the user can still make this first page into an effective table of contents by manually 
putting the desired information on the first line of each page. 

2.3 The Window 

As mentioned earlier, E is a display-oriented editor. Since the screen size will not usually permit 
the display of an entire page of text, E exhibits the text that is being edited as if through a window, 
there being special single-character commands that move this window around on a page of the text. 
One line of text within the window, the arrow line, is marked with an arrow to its left. More 
will be said about this later. Also, when editing a line of text, a CURSOR will underline one 
character in this arrow line. 

As an aid to the user, F provides certain bits of information on the screen, in addition to the text 
itself, that tell the user something about the file that is being editing and the state of the editing. 
This information is contained in a top and bottom 'border line', the top called the header line and 
the bottom called the trailer line. These lines may contain cither a series of asterisks, indicating 
that there is no more text in the header or trailer direction, or a scries of dots, indicating that there 
is some text in the indicated direction that is in core but that docs not show in the window. 

The header line also contains the following: 

1 The number of the text line that appears just below the header line. 

2 The numbcr(s) of the in-core pagc(s). 

3 The name of the file being edited. 

4 Some information as to the editing mode (to be explained later). 

The trailer line also contains: 

1 The number of the current line (at the arrow) that will be entered if one starts to type. 
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2 The total number of lines on the current page. 

3 The number of the current page. 

4 The total number of pages in the file being edited. 

5 Some information about the size of the page in core (do an ET? for more details). 

In addition to the trailing line there is a region below it where typed-in information is echoed and 
where certain bits of information are typed out, either to inform the user of the status of his editing 
or to answer certain questions that he can ask.For example, the message "Rippling" may appear 
here to signify that E is readjusting the disk assignment of your file in response to an increase in 
the size of a page. Two commands (<8>XTERSE<CR> and ®XVERBOSE<CR>) enable the user to either 
restrict or expand the amount of information that E provides. There may also be two lines of 
information above the heading line (the WHO lines) that contain system information. 

2.4 Special Keys 

There are two rather special keys on the DataDisc keyboard. These keys, the CONTROL and MEl'A 
keys, are always used with other keys to control their meaning and they must always be depressed 
before, and held down during, the striking of the associated key (just as one uses the sillFr and top 
keys). In general, these special keys transform all of the normal typewriter keys into H commands. 
In this and other manuals these keys are indicated cither by <control> and <meta> in angle 
brackets, as here shown, or by a short-hand notation consisting of a for <C0NTR0l > and /? for 
<meta>, a/3 for both <control> and <meta>, and finally, <8> for those cases where it is optional to 
use either the <control> key alone or both the <control> and <meta> keys (but not the <meta> 
key alone). The edit key on the DataMedia keyboard takes the place of the CONTROL key but 
there is no equivalent key to the meta key. Instead, one must precede the character in question 
with holding the edit key and typing the nul key. 

For example, to get a/J<CR> on a DataDisc, hold down the <CONTROL> and <META> keys then 
depress the <CR> key. To get this on a DataMedia, hold down the <edit> key, then depress the 
<nul> key, and then, still holding the <edit> key, depress the <CR> key. 

The exact meaning of the CONTROL and meta keys if used separately or together varies with the 
conditions. Remember: do not type the character a or /?, but rather use the special keys that are 
thus referenced. 

Numerical arguments are frequently used with certain commands. Arguments will be indicated in 
this manual by the symbol # or by a typical numerical example. When the control and/or 
meta keys are indicated, these keys must be held down for all digits of the number. 

There are several other keys on the DataDisc keyboard that are used for special purposes by E. 
These will be referenced by their names in angle brackets, such as: <form>. <vt>, <bs>, <linf>, 
<alt>. The carriage return key (marked <return> on the DataDisc and DataMedia keyboards and 
referenced in this manual as <CR>) also is used for several special purposes, as will be noted later. 
These keys arc not held down while striking other keys although they may be used with the 
control and MIT'A keys. Sec Appendix A for the corresponding keys on the DataMedia. 

2.5 To Start an Editing Session Using K 

To start an editing session using E one types FT FOO<CR> where l"00 is the name of an existing file. 
If one wants to create a new file named FOO, the system command is Cl-T FOO<CR>. E allows files 
to be opened in cither the read-write mode or in a read-only mode. One enters a file in the 
read-only mode by using ER instead of HT or by typing /R between the end of the name and the 
<CR>. The /R is called a switch, of which there are several, as v\ill be explained later. The read- 
only mode should always be used if one wishes to read a file but not to make any changes to it. 
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When in this mode, edited changes may be made in the in-core copy but E will not permit this 
copy to be written out on the disk unless the mode is changed to read-write. 

2.6 E Commands 

Most of the commands used in E are single characters typed with the control and/or the meta 
keys. These characters arc usually mnemonics for the type of action that is being called for, but this 
is not always possible and some of them will simply have to be learned through frequent use. A 
few keys, such as the <CR> key, can be used as single-character E commands without the use of the 
control or meta key. Other keys, if typed without the control or meta key, will simply cause 
the indicated character to appear in the text, as explained in detail below. 

Since there are many more commands than there are letters, some of the less frequently used (or 
more dangerous) commands require the typing of several letters.. These commands all begin with 
®X (for eXtend) followed by enough letters from the name (without special keys) to disambiguate 
the command. If not enough letters are typed, E will complain and ask you to retype the 
command. <8>X commands are terminated by a carriage return <CR> or in a few special cases by 
some other activating character. They often allow for extra parameters, to be typed between the 
name and the termination. 

The <alt> key performs a rather special function in E, that of aborting any partially-typed 
command. In general, when one discovers that one is typing the wrong thing, it is usually safer and 
easier to type <alt> than to try some other means of correcting the error. In particular, <alt> will: 
abort any partially typed <8>X command; restore any line currently being edited in the line-edit or 
insert mode (to be discribed later) to its previous contents; terminate- and abort any search or 
substitute command being typed. 

Many E commands will accept a prefixed numerical argument, as will be explained in more detail 
later. It may be worth noting at this time that most of these commands may be made to report 
some information concerning the command, without actually executing it, by using a zero prefixed 
argument. This is often a very useful way of finding out what the command might do or what its 
current mode of operation may be. Information so reported is typed out at the bottom of the 
screen. 

2.7 Editing Modes 

The various options available to the user are grouped together into a few distinct modes. The 
default mode that E enters initially is called the normal mode and this is the mode from which 
one enters most of the other modes. Many of the commands that may be used in the different 
modes will be described later. For the moment, it is important to recognize the existence of these 
different modes, since some commands have quite different actions in the different modes, and to 
learn a few of the commands that are so affected. 

2.7.1 The NORMAL Mode 

The normal mode allows for movement between files, from page to page and within the page to 
arrive at any desired line. In normal editing, one will switch from this mode to other modes, as 
required, and will return to this mode frequently. Commands that affect, or relate to, an entire 
page or entire file arc also executed in this mode. In fact, much of the power of the E editor 
resides in the large array of commands that are available in the NORMAL mode. 

While in the normal mode, an arrow appears on the screen, to the left of the text. The line on 
which the arrow appears will be called the arrow l inl. On some terminals, in particular on the 
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DataMedia, the arrow line is identified by an underscore or CURSOR under the first character of 
the line. 

Some special normal mode commands should be learned at this time. 

®4<CR> Move the arrow down 4 lines (but not beyond the trailer line). 

a<CR> No action when in this mode but used to return to it from other modes. 

/?<cr> Introduce an empty line ahead of the arrow line. 

a/?<CR> Enter the line-insert mode (see below) and introduce an empty line as the arrow line. 

D Enter the line-edit mode and overwrite the first character in the arrow line with a "D". 

®3aD Enter the LINE-EDIT mode and delete the first 3 characters in the ARROW LINE. 
/3D Enter the line-edit mode and insert the character "D" ahead of the first character. 
<8>6a/?D Delete 6 lines starting with the arrow-line. 

2.7.2 The line- EDIT Mode 

This mode is used for making deletions, corrections and additions to text. It is frequently entered 
from the normal mode simply by starting to type, using any one of the normal typewriter keys 
without any of the special control keys that are used to identify E commands. Many of the 
commands that are used to move around within a line of text may also be used to enter the LINE- 
EDIT mode, as will be explained later. 

While in this mode, any typing that is done will appear in the ARROW LINE, and a CURSOR 
(underscore) will appear under the character position where the next typed character will be placed. 
On the DataMedia, the ARROW line will appear brighter than the other lines so as to differentiate 
the line- edit mode (where the CURSOR is used as just discribed) from the NORMAL mode (where 
the cursor is used to indicate the arrow line). 

The carriage return key (<CR>) is normally used to terminate the LINE-EDIT mode and to return to 
the normal mode with the arrow moved to the next line. It will perform this function even 
when the CURSOR is not at the end of the line being edited and the line will be written into the in- 
core copy in the same form as it appears on the screen. To insert a carriage return into the line at 
the CURSOR position (when in the line-edit mode) one must use the /?<CR> command, as will be 
explained in detail later. 

E docs not automatically start a new line of text after some fixed number of characters (as some 
editors do), so the user must break his lines by typing carriage returns (or by any one of several 
special commands, as noted in section 5,3 below). 

While E is capable of dealing with very long lines by use of some special commands, lines of text as 
typed must not exceed 133 characters in length. This limitation comes about because E makes use 
of the System Line Editor, which has such a limit. Offsetting this limitation is the feature that the 
line is actually copied whenever one enters the line-edit mode and the original in-core line may be 
left unaltered by a single command (the <ali> key) should one wish to abort the current changes at 
any time before typing the final <CR>. 

2.7.3 The INSERT Mode 

This mode is used when one wants to insert a substantial amount of new text in a line. It is 
entered from the line-edit mode or the normal mode by typing ol. While in this mode, 
everything that one types (including carriage returns) will be inserted in the line. It also differs 
from the line-edit mode in that the newly typed text is inserted into the old text (that is, it does 
not overwrite), with the displaced text being moved along to make room. In this mode, the carriage 
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return, <CR>, without control key, docs not terminate the mode but instead causes a carriage return 
to be inserted into the text. This mode is usually terminated by typing a<CR>. The insert mode 
differs from the LINK-INSERT mode (to be discribed next) in that the <alt> key may be used to 
restore the line to its original condition (but only back to the last typed <CR>, if one has been typed 
while in the insert mode). 

2.7.4 The LINE-INSERT Mode 

This mode is used when one wishes to insert one or more lines of text between existing lines. It is 
entered from the normal and insert modes by typing a/61 or a/?<CR>. While in this mode, 
everything that is typed (including carriage returns) will appear in the text. This mode is 
distinguished by the presence of the letter "I" in the header line and by the use of a double arrow 
in place of a single arrow in front of the arrow line. It is terminated by typing a<CR> or <ALT>. 
The a<CR> command, if given at the beginning of a new line, will allow the empty line to remain in 
the text, while the <alt> command will abort the empty line (but it will not abort a line containing 
text, as it does in the insert mode). 

2.7.5 The ATTACH mode 

While in this mode, a selected portion of the text is removed from the in-core text and is held in a 
special ATrACH buffer in such a way that it can be moved around within the opened file, or even 
moved to another file, by using the same commands that are used in the normal mode. At all 
times, the text in the attach buffer (or the first few and last few lines, if the selection is longer 
than a certain size) is shown on the screen at the position in the in-core text where it will be 
deposited should the appropriate release command be given. This mode is distinguished by the 
presence of the letter "A" in the header line and by vertical bars to the left of the attached text 
(brightening on the DataMedia). The commands for entering and leaving this mode will be 
described later. 

2.8 Saving Corrections and Exiting from E 

The command <8>. causes the recently typed text to be written onto the disk. Please note that the 
period is the command. One should also note that the process of going to another page or of 
switching to another file also causes all corrections and additions to be written onto the disk. 

To end the session and save recently made corrections type <8>E. To end the session without saving 
the recently typed text, type <8>Xqltt<CR>. One can, of course, exit by using the <call> key but 
this does not restore the screen as does the ®Xquit command. After exiting, it is possible to 
reinstate the editor and redisplay the text by the system command CONTINUE. It is also possible to 
exit from E and go directly to certain other programs. 

<8>XGO<CR> Exit from E as with <8>E and then repeat the last RPG command. This is an easy 
way to get back to a compiler after making corrections to a program. 

<8>Xrsys <program><CR> Exit from R as with <8>E and run the system program as specified. 

®Xrun <program><CR> Exit from E as with ®E and run the user program as specified. 

<8>Xdrd<CR> Exit from E as with <8>E and run the system program dired. 
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3. A Typical Editing Session • 

If you are a beginner at using E, a session with help eteacii is recommended. If you have had 
some experience with cither E or some other editor, the following brief summary of a typical 
editing session may be useful. References are given for locations where the detailed discription of 
each command (and related commands) may be found. 

CET newfile<cr> This opens a new file named newfile. (section 2.5 page 5) 

<8>Xoldfile<cr> Entering this file in read-only mode, (section 4.2 page 11) 

<8>P This command might be repeated several times, (section 4.1 page 10) 

<FORM>This brings in another windowful. (section 4.1.2 page 10) 

®> Move the arrow down to the middle of the window. We will assume that this places the 

ARROW at a line in a paragraph that you want to copy, (section 4.1.3 page 10) 
a/JM So mark this line, (section 4.3 page 11) 
aH Now back to newfile. (section 4.2 page 11) 

You are now typing into NEWFILE (in LINE-EDIT mode) and this line of text will appear exactly as here typed. 
<CR> Each carriage return that you type brings you back to the NORMAL MODE and moves the 

arrow to the ne,xt line where you may continue typing, (section 5.3 page 13) 
®? Maybe a brief look at E.ALS[UP,DOC] might help at this point, (section 4.2 page 11) 
aH You are now back in newfile so that you can continue typing as you wish. (A second aH 

would switch you to oldfile, not to E.ALS.) 
®Xmark<CR> It is time to start a new page. The first page will be automatically saved and 

you may continue typing into this second page, (section 8.1 page 18) 
/}<CR> If given while in the normal mode, this command will insert an empty line into the text 

ahead of the arrow line, (section 2.7.1 page 7) 
a<CR> This enables you to finish typing or editing a line and return to the normal mode with the 

ARROW pointing to the same line, (section 5.3 page 13) 
a/?M Mark the line, (section 4.3 page 11) 

<8>-®P Going back a page to make some corrections. The second page will be saved. 
®oo a L Move the ARROW to the end of the page, (section 4.1.3 page 10) 
a/?4<RS> Back up to the fourth line of text from the bottom, (section 4.1.3 page 10) 
a<TAB> Move the CURSOR to the end of this line. This command will enter the line-edit mode. 

(section 5.1 page 12) 
<bs> This backs up the cursor and deletes the last character. You can back up as much as 

desired and then start typing, ending always with a <CR>. (section 5.1 page 12) 
aL Now back to the first line on this page, (section 4.1.3 page 10) 
a/S2a(lD This deletes the first two lines on the page, (section 9.1 page 21) 
®E This ends the session, (section 2.8 page 8) 
To Resume Editing if You Forgot Something. 
CONTlNUE<CR> If this system command is given immediately after the ®E command everything 

will be restored just as if you had not given the <8>E command, except, of course, the results 

of your earlier session will have been written onto the disk, 
all This will still return you to oldfile. 
aM This returns you to the previously marked line. 

•a!<8>C Attach a copy of the paragraph that contains the marked line, (section 9.5 page 21) 
aH Move this attachment to NEWFILE. 

aM And to the position where the mark in this file had been placed. 
®E Deposit the attachment at this point, (section 6.1 page 14) 
<8>Xjfii.i.<CR> This page looks ragged since the copied text was formatted differently and you 

have been careless about line lengths, so adjust the line lengths for the entire page to be 

equal or less than the default value, (section 8.3 page 18). 
®E Now you arc through, (section 2.8 page 8) 
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4. Moving Around (while in the NORMAL and ATTACH Modes) 

Some of the more important commands for moving within a single file and from file to file will be 
listed here. For a complete list of these commands see F..ALS[UP,DOC]. 

4.1 Moving within a Given File 

4.1.1 Moving from page to page (after writing out the current page to the disk) 

®P Go to the next page (note that <8> + ®l is implied). 

®6<8>P Go to page number 6. 

®-<8>P Go back a page. 

aO Go to the previously viewed (Old) page as listed in the page stack. 

a/30 Go to the second previously viewed page as listed in the page stack. The meaning of 

this command can be changed by the user. For details see E.ALS. 
®#aO Go to the #th previous referenced page in the page stack. 
®0aO Type out the page stack (at the bottom of the screen) listing the more recently 

referenced pages, so that one may return to them directly. 

4.1.2 Window-moving commands (moving the ARROW, if necessary) 

<FORM> Move forward one windowful but do not cross a page boundary. 

<vt> Move backward one windowful but do not cross a page boundary. 

<8><form> Move forward one windowful even if this means writing out the page and crossing a 

page boundary. 
<8><VT> Move backward one windowful even if this means writing out the page and crossing a 

page boundary. 

®J Jump the window so that the arrow line is at the top of the screen.. 

<8>0®J Jump the window to put the the arrow line in the middle of the screen. 

<8> — ®J Jump the window to put the line arrow line at the bottom of the screen. 

<8>T Move the window up to show 4 more lines at the top. 

<8>B Move the window down to show 4 more lines at the bottom, 

(sec e.als for more) 

4.1.3 ARROW-moving commands (moving the window, if necessary) 

<CR> Move the arrow down a line. 

<bs> Move the arrow up a line. 

<8» Move the arrow down 4 lines. 

<8>< Move the arrow up 4 lines. 

<B>> Move the arrow down 1/2 screen. 

®< Move the arrow up 1/2 screen. 

<S>A Move the arrow to the top line in the window. 

®V Move the arrow to the bottom line in the window. 

aL Move the arrow to the first line of the current page. 

a,GL Move the arrow to the first line of the in-core text (there may be more than one page). 

®#«L Move the arrow to the #th line of the page. Note that the line numbers do not appear 
on the text and they arc not recorded, but H keeps track of them during the editing session 
so that they may be referenced. 
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aN Move the arrow to the hist referenced line as listed in the line stack. The line stack is 
cleared on changing pages. 

afiN Move the arrow to the second previously referenced line as listed in the line stack. 

The meaning of this command can be changed by the user. For details sec i-.als. 

<8>#aN Move the ARROW to the #th previous line in the line stack. 
®0<8>N Type the line stack (at the bottom of the screen). 

4.2 Moving to Other Files 

The task of moving back and forth between files is greatly simplified by the fact that K keeps a 
stack record of all recently visited files. Mies once visited during any one editing session may be 
revisited by using one of the II (for Home) commands. File-switching commands that contain file 
names may carry switches as defined in Appendix B. All file-switching commands write out the 
current page, if it has been modified, before changing files. Some useful commands arc: 

®eFOO<CR> Leave the present file and enter file I 00 in the read-write mode (that is, so that 

it can be modified). The mode can be changed later by the command <8>XRPAD0NI.Y<CR>. 
The name of the file being left, together with the last referenced page and line number, will 
be placed in an internal file stack for use by the oil command, as noted below. 

<8>eNi:wiVC<CR> Leave the present file and enter a newly created file named nfwf. 

®Ai 00<cr> Leave the present file and enter file roo in the read-only mode. The mode 

can be changed later by the command <8>Xrf.aowritf.<cr>. 

<S>ai.ongfu.i:/F<cr> Leave the present file and enter the file named longfilf, repaging and 
reformatting the core version only, without changing the disk copy. This is useful for 
examining an unformatted file with huge pages that has been produced by a program other 
than R 

®? Leave the present file and enter the i-.afs on-line-manual file, cither at page 2 or, if it has 
been previously referenced during the session, at the last referenced position. The «H 
command will return to the present file without adding f.ai.S to the file stack. 

aH Return (Home) to the last referenced file at the page and line last referenced. 

apH Go to the second previously referenced file at the page and line last referenced. The 
meaning of this command can be changed by the user. For details sec u.ALS. 

a#aH Go to #th previous referenced file as listed in the file stack. 

aOaU Type out (at the bottom of the screen) the file stack, listing the numbers that may be used 
to reference the files in the a#aH command. Note: the shown in this command is the 
numeral zero, not the letter "O". 

4.3 Aids in Moving Around 

In addition to the file, page and line stacks that F maintains automatically, up to 23 lines in each 
referenced file may be marked by the user. These marks are saved and restored as one switches 
from file to file. Note mat these marks are stored in the order of their appearance in the file so 
that they may be used to move through the file in an orderly fashion. The marks arc not put into a 
stack as are the automatically-recorded aO and aN references. 

a/?M Mark the arrow linf, recording the page number and the line number. 

«M Go to the next mark (cyclically). 

— «M Go to the previous mark (cyclically). 
®#aM Go to the #th mark forward (cyclically). 
®X/.mark<cr> Zero (clear) the marks in the current file. 
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5. Editing Lines of Text in the LINE-EDIT Mode 

As mentioned earlier, deletions, corrections and additions to lines of text can be made using the 
LINE-EDIT mode. While in this mode, any normal typing that is done will appear in the ARROW LINE 
and will overwrite characters that are in positions marked by the CURSOR. It may be worth 
repeating at this point that the line editor will only handle lines that contain less than 133 
characters, so the user must terminate lines as they are being typed by using the <CR> key. 

The line-edit mode is entered from the normal mode either by typing any normal printing 
character (including the space bar and the tab key), or by typing any one of the special LINE-EDIT 
commands given below except for those marked (will not enter). Commands that are so designated 
have a different meaning in the normal mode from their meaning in the line-edit mode and so 
cannot be used to enter. It should also be noted that the line-edit mode cannot be entered while 
in the ATTACH mode. A limited number of NORMAL mode commands may, however, be given 
while in the LINE-EDIT mode. 

5.1 Moving the CURSOR 

a<SPACE> Move the CURSOR to the right 1 character. 

a4a<SPACE> Move the CURSOR to the right 4 characters. 

<bs> Move the cursor to the left 1 character, deleting the character iff at the end of the 

line, (will not enter) 
a<BS> Move the CURSOR to the left 1 character but do not erase, (will not enter) 

a5a<JiS> Move the CURSOR to the left 5 characters, (will not enter) 
c*/?<space> Move the cursor to the right continuously as long as the space bar is depressed (only 

repeats on the DataDisc). 
a<TAB> Move the CURSOR to the end of the line. 
a<FORM> Move the CURSOR to the start of the line, (will not enter) 
aS then <char> Move the cursor (Skip) to the next occurrence of.<char>. 
aiaS then <char> Move the cursor (Skip) to the 3rd next occurrence of <char> ■ 
aB then <char> Move the CURSOR Backward to the nearest occurrence of <char>. (will not 

enter) 
a6aB then <char> Move the CURSOR Backward to the 6th nearest occurrence of <char>. (will not 

enter) 
all Repeat the last aS, aK, aB or aL command (saves retyping the <char>). 

5.2 Inserting or Deleting Characters 

/Kchar> Make room and insert <char> ahead of the character that is in the CURSOR position. 
aD Delete the character at the CURSOR position and move the rest of the line to the left. If 

at the end of the line this will append the next line, but only if this does not make the 

line too long for the line-editor. 
ct4aD Delete 4 characters storting at the CURSOR position (this will append the next line only 

if given at the end of the line). 
aK<char> Kill characters starting at the CURSOR position, up to but not including the first 

appearance of the character typed. Do nothing if no such character is found. 
aK<CR> Kill the rest of the line storting at the CURSOR position. 
al.<char> Kill backward starting to the left of the CURSOR, up to but not including the first 

encountered occurrence of the character typed, (will not enter) 
aL<CR> Kill backward everything before the CURSOR position to the start of the line, (will not 
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enter) 
aR Repeat the last aS, aK, aB or aL command (saves retyping the <char>). 

aT Transpose the order of the two characters just to the left of the CURSOR (to correct a 

common typing error), (will not enter) 

5.3 Leaving the line-edit Mode 

There are several commands for returning to the normal mode. These may be given with the 

CURSOR at any position within the line and when so given a carriage return (actually a <crlf>) will 

be placed at the end of the line, if the line is not already so terminated, and the line will be written 

into the in-core copy exactly as it appears on the screen. 

<CR> Accept the line, leave line-edit mode and move the arrow to the next line. 

a<CR> Accept the line, leave line-edit mode but do not move the arrow. 

<g>U Accept the line, leave the line-edit mode and move the ARROW Up one line. 

<alt> Restore the line to its original condition and leave the line-edit mode. 

One may also leave the line-edit mode and enter either the INSERT mode or the line-insert 

mode. 

al Enter the insert mode (like holding <meta> continuously). When in the INSERT 

mode, any line-edit command will return to the line-edit mode. 
a/?<CR> Break the line at the CURSOR and enter the line-insert mode with the CURSOR at the 

end of the first segment of the original line. 
a/3? Enter the line-insert mode at the end of the previous line. 

a/31 Enter the line-insert mode at the end of the following line. 

5.4 Move to Another Line, still in the line-edit Mode. 

These commands will accept numerical arguments, that must be given with aft, to specify the 
number of lines to move in the direction indicated. The direction in which the semicolon and colon 
commands move can best be remembered by noting that they move in the same direction as 
indicated by the t and 4- symbols that are typed with these same keys. 

at Move to the end of the previous line. 

al Move the the end of the following line. 

aj8; Define the present column position as the column of interest and move to this column 

in the previous line (if possible, otherwise to the end of the line), 
a; Move to the COLUMN OF interest (as earlier defined) in the previous line (if possible), 

without regard for the current column position. 
a/?: Define the present column position as the COLUMN OF interest and move to this column 

in the following line (if possible, otherwise to the end of the line). 
a: Move to the column OF interest (as earlier defined) in the following line (if 

possible), without regard for the current column position. 

5.5 Duplicating a Line 

<8>Q Make a copy of the line just above the arrow line and enter the line-edit mode in this 
newly created line. This is particularly useful if one needs a second line that is but slightly 
changed from an existing one. 
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6. Attaching and Copying Lines of Text 

The Attach command removes the lines of text from the core image of the page and places them in 
a special attach buffer. The lines arc still displayed on the screen in their original position (if there 
are more than a limited number of lines, then only the first and the last few lines arc shown). The 
attached lines arc marked with vertical bars at the left (except on DataMedias, where they are 
displayed in boldface). The apparent position of the attachment (and the place that it will be 
deposited) can be moved around with all of the usual page-moving, arrow-moving and file-switching 
commands (as described in Section 4 above). The Copy command first makes a copy of the desired 
text and then attaches this copy. 

One note of caution: when moving a large portion of text from page to page, and particularly from 
file to file, it is safer to use the Copy command and then subsequently delete the original record 
than it is to use the Attach command, since the lines in the Attach buffer arc not written on the 
disk and they could be lost if the system (or E) should malfunction while switching pages or files. 

This is a good place to comment on the rippling report, that may appear on the bottom of the 
screen, particularly when moving text from page to page. This will occur whenever an increase in 
the size of a page requires that the disk assignments be altered. 

6.1 Basic Commands 

®A Attach the ARROW line (removing it from the in-core text). 

<8>C Copy and attach the copy of the arrow line. If this command is given when there is 

already something in the attach buffer, then the entire attachment will be deposited and 
recopied. This provides a convenient way to make multiple copies of any desired 
portion of text. 

®4<8>A Attach 4 lines starting with the arrow line. 

<8>2®C Copy and attach the copy of 2 lines starting with the arrow line. 

a!<8>A Attach the current paragraph. See Section 8.6 for more details. 

a/3|®A Attach the rest of the current paragraph starting with the arrow line. 

<8>E Deposit the attached lines into the core image at the location shown on the screen and 

return to the normal mode. Caution: striking E a second time will write out the 

page and leave E, so give the system time to react. 
afiR Replace the attached lines in their original position. This is extremely useful if you 

find that you arc moving the wrong lines and you arc not sure where you got them. 
a/?K Kill the attached lines. Note: aK does not work. If one makes a practice of using the 

control key alone for those cases where it will work, one may avoid the danger of 

accidentally killing an attachment. 
a/34a/?K Kill the first 4 lines in the Attach buffer. (See ®-®C below.) 

6.2 Commands with Relative Arguments (to add or remove lines from the end of the attach buffer). 
All of these commands will also accept numerical arguments. Note that these commands allow one 
to assemble text abstracted from different locations ami indeed from different (lies for eventual 
depositing at a single location. 

® + ® A Attach one more line to the end of the attach buffer. 

<8> + ®3<8>A Attach three more lines to the attach buffer. 

® - <8> A Detach one line from the end of ihc attach buffer. 

<8> + <8>C Copy one more line and add it to the end of the attach buffer. 

<8> - <8>C Delete (kill) one line from the end of the attach buffer. 

® - ®3<8>C Delete (kill) three lines from the end of the attach buffer. 
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7. Search (FIND) and Substitution Commands 

E provides a fairly elaborate set of search and substitution commands that can be applied to a single 
page or to an entire file. 

Single page searches use the ®F command, while multi-page searches use the extended command 
®Xfind. In both cases the command is executed starting with the arrow line and extends either 
to the end of the current page or to the end of the file. When the current ARROW LINE has been 
reached as the result of an earlier search, the new search will begin just beyond the first character of 
this earlier found occurrence of the scarched-for string. Multi-page searches may be terminated at 
the end of the page that is currently being searched by giving the command <ESC>I (the page 
number of the last-searched page will be reported). 

Two commands, <8> # ®XSSLINE<CR> and <8> # <8>Xsspage<CR> arc available to set the search limit, 
i.e., to stop the search before the specified line or page for all subsequently issued commands 
(except for directory searches). 

If the search is to be for a delimited string (i.e., a portion of text that is separated from the rest of 
the text by spaces, tabs, <CR>s or other speciat characters), both the <control> and the <meta> keys 
arc used, while only the <control> key is used when initiating a non-delimited search. This is an 
important distinction. 

The default form of <8>F and ®Xfind is to consider upper and lower case letters to be equivalent 
but the command <8>Xexact<CR> can be used to force a case distinction for all subsequent searches 
(with <8>-<8>Xexact<CR> to undo the distinction). 

There are several symbols that have special meanings when used in the searched-for string, as 
shown in the following table. If these characters are desired as ordinary characters in the 
scarched-for string they must be preceded by the identity symbol = . 

Symbol Meaning 

V Any character may appear in this position. 

-1 Any character except for the one that follows this symbol may appear. 

I Any delimiter (not a letter, number or $ % or_ ) may appear. 

= Treat (quote) the (normally special) symbol that follows as an ordinary character. 

00 Not now used but must be quoted. 

C Not now used but must be quoted. 

Finally, the action to be taken on the successful completion of the search may be specified by the 
delimiter that is used to terminate the searched-for string. Commonly used delimiters are: <CR>, 
which calls for the arrow to be move to the first line in which the searched-for string is to be 
found, and a<CR>, which causes the line-edit mode to be entered with the cursor positioned 
under the first letter of the scarched-for string. Other delimiters are described in Section 7.1 below. 
Should the search be unsuccessful, no action is taken, the ARROW line remains undisturbed and the 
failure is reported. 

A few examples follow. 

«FSmith<CR> Find the first occurrence of the string SMITH or smith or even smith in 
blacksmith or in Smithsonian on the current page, starting with the present ARROW 
line:, and move the ARROW to this new line. There is to be no space after the F 
since this is a single-letter command. 
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aXF smith<CR> Same as above but searching from the arrow line to the end of the file. Note 
the space after the F. Also note that currently there are no other word commands 
starting with F, so only the F of find need be typed, but there must be a single 
space after the F in this case to signal the end of the word. 

aXF smitha<CR> As above but enter the line editor with the CURSOR under the first letter of the 
searched- for string. 

a/?Fsmith<CR> Find the delimited string smith. This would not find smith in blacksmith or in 
Smithfield. 

®9c*/?Fsmith<CR> Find the 9th occurrence of the string. If there are fewer than 9 occurrences 
report the number and do not move the arrow. Note: asking for an impossibly 
large number (such as <8>oo) is a convenient way to have the occurrences counted. 

7.1 Search-String Terminators 

It will be possible to list but a few of the more important search-string-terminating commands. 
Remember, these terminators are to be used as a part of a search command. They have quite 
different meanings when typed separately. 

<CR> Move the arrow to the line found or report failure. 

a<CR> Move the arrow to the line found, enter the line editor and place the cursor under the 
first character of the scarched-for string. 

®J Jump the line with the searched-for string to the top of the window. 

<8»A Attach all lines starting with the arrow linf up to and including the line in which the 
searched-for string is found. If this termination is used with the extended search command 
and if the string found is not on the in-core pagc(s), the attachment will start at the 
beginning of the page containing the string. 

a/JD Delete all lines up to but not including the line containing the searched-for string. This is a 
very dangerous command so use it with extreme caution. 

aP Make the search over the directory page (but without moving the window to it) and then 
display the referenced page with the arrow pointing to the first line on this page. 

a/?P Make the search over the directory page (but without moving the window to it) and then 
display the referenced page with the arrow pointing to the second occurrence on this page 
of the scarched-for string (the first being in the top line). 

<8> + <8>P Just like ® P except that the search starts with the next page after the current one. 

®: Make the search over the directory page and then display the referenced page with the 
ARROW pointing to the line containing the referenced string as a label (see F.ALS for 
details). 

®\ Terminate the searched-for string and prepare to accept a substitution string. See section 7.3 
below. 

<lini:> Like <S>\ for use on terminals without control and mfia keys. 

<alt> Abort the present search command that is in process of being typed. 

7.2 Repeating Search Commands 

The last-used search strings arc remembered by F (that is, they are sticky). For a repeat, one can 
type the rest of the command including the desired termination (which may differ from the 
termination used the first time), but omitting the string and the previously defined string will be 
used. The search string for a within-a-pagc search and the search string for an extended search arc 
remembered independently. 
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There arc even simpler commands to ask for a repeat of the last search. 
a* Find the next occurrence of the string specified by the last search command (whether a 

single-page or a multi-page search). Leave the line in the line editor. 
afi* Find the next occurrence as above but do not enter the line editor. 

7.3 Substitution Commands 

Substitution commands are initiated by first giving a normal search command that is terminated 
with <8>\ (or <line>) and following this with the string to be substituted, exactly as one wants it to 
appear. The substitution string, in turn, is terminated by a <CR> or a a<CR> and this can have a 
prefixed numerical argument which specifies how many substitutions are to be made (see examples 
below). Note this distinction: a prefixed argument to the search part specifies where the 
substitution is to start while the argument before the final termination specifies the number of 
substitutions that are to be made. Substitution strings, so specified, are sticky and need not be 
retyped for repeat commands. Null substitutions are allowed, so be careful. Type <ALT> to abort 
a partially typed search or substitution command. 

If several identical substitutions are to be made, it is usually wise to make a single substitution 
initially, using the a<CR> termination, and then to make the rest of the substitutions using the repeat 
command ®#a/?\ after checking that the first desired substitution has indeed been made correctly. 
This procedure is especially recommended when substituting a null string! The infinity sign (oo) 
can be used as the argument if substitutions are to be made for all occurrences. 

Sample commands are: 

a/?Fstringaa/J\Stringb<CR> Find the first occurrence of stringa (or Stringa) and replace it by 

Stringb, where the indicated upper and lower cases in the substitution string are to be as 
typed. Do not leave the line in the line editor. Note: this is faster than with the a<CR> 
termination but the substitution is not cancellable with <alt>. 

a/3Fstringaa/?\Stringba<CR> As above but leave the line in the LINE EDITOR with the CURSOR 
under the last character of the substituted string. This is slower than die a<CR> termination 
but it has die advantage that the substitution may be cancelled by the <alt> command. 
Use this command if you arc not certain that you have the correct substitution. It is also 
good practice always to make a single substitution first and then to use the repeat 
command, shown below, for other desired substitutions after verifying that the desired 
substitution has, in fact, been made. 

®9a/?FSTRlNGAa/?\STRlNGBa/?co<CR> Find all occurrences of the string STRINGA and start the 
substitutions of stringb for stringa at the 9th occurrence. 

a\ Repeat the previously-made substitution at the next occurrence of the searched-for string, 
leaving the line in the line editor with the cursor under the last character of the 
substituted string. Note the a\ requires no other termination in this case. 

a(i\ Repeat the previously-made substitution at the next occurrence of the searched-for string 
but do not leave the line in the line EDITOR. This is faster than the a\ command. 

®6ap\ Repeat the previously-made substitution for the next 6 occurrences. One should always 
use a/?\ as here shown and not the a\ command which causes a lot of useless entering and 
leaving of the line editor. On the completion of the last substitution, the o<CR> 
command will cause the LINE editor to be entered and the CURSOR to be moved to the 
last character of the last substitution, if this is desired. 

®oo a /?\ Repeat the substitution until all occurrences of die searched-for string have been 
replaced (within the range specified in the original substitution). 

®0<8>\ Report, the last-used searched-for and substitution strings. 



18 



Section 8: Text Formatting Commands 



8. Text Formatting Commands 

Text formatting commands in E are given while in the normal or attach mode. They usually 
apply to the specified number of lines or, by default, either to an entire page (or attach buffer) or 
to a single line as will be noted iater. Commands given in the attach mode always apply to the 
contents of the attach buffer. 

8.1 Page Appending, Dividing and Combining Commands 

®Xappenlxcr> Append the next page to the page (or pages) that are in core so that the two or 
more pages may be viewed and edited togather. The in-core page mark 
will be represented on the screen by a line of vertical bars. 
Split the current page into two pages with the arrow line as the first line of 
the newly created page and retain both pages in core without writing out 
anythin The in-core page mark will appear as a line of vertical bars. 
Split the current page as above but write out the in-core pages. Retain in core 
only the new page, now starting at the ARROW line. If this command is given 
in the attach mode, the attached lines are first put down and then the page is 
divided. If the attachment is not at the top of a page the division is at the 
beginning of the former attachment. If the attachment is a the top of the 
page, the division is at the end of the former attachment. In either case, the 
arrow is at the top line of the former attachment and only this page is 
retained in core. 

Delete the page mark at the end of the last in-core page and add the text of 
the next page to the last in-core page, writing out the resulting text. 
When given with the arrow pointing to an in-core page mark, delete this 
page mark without writing out the resulting text. 



/?<FORM> 



®Xmark<cr> 



<8>Xdelete<cr> 



a/8D 



8.2 Line Breaking and Joining Commands (particularly useful for lines without word separators and 
for lines that are too long for the line-editor) 

<8>Xbreak 60<CR> Break the arrow line: (once) after the 60th column (the initial default column 
is 80). A preceding numerical argument of one or larger will cause that many 
lines to be broken as many times as necessary (sec the next command). 

<8>4<8>Xbkeak<CR> Break 4 lines starting with the arrow line as many times as necessary so that 
none of the resulting lines arc longer than the default length. 

®4<8>Xjoin<CR> Join tine 4 lines starting with the ARROW line into one line by removing the 
CRLFs. The default argument for this command is 2 lines. 

8.3 Line Filling and Justifying Commands (for use with normal text) 

Only the simpler forms of these commands will be described in this manual. E actually provides a 
wide range of commands for justifying text and tables. Sec the e.als manual for details. If the 
text is already broken into paragraphs that arc separated by blank lines then the default options 
may be used. It is usually wise to save any recent corrections by doing a <8>. before using these 
commands so that one can'undo their effect with the ®Xcancel<CR> command if necessary. The 
0XUNDEI ete<CR> command may also be used to undo the effects of these commands. 

All of thc>c commands can be preceded by a numerical argument to define their range of action. If 
given when there is text in the aitacii buffer, they will apply to the attachment only. The <8>! 
prefix is particularly useful in defining the range, as will be noted below. If the range is not 
otherwise specified, the command applies to the entire page or to the entire aitacii buffer. 
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These commands will accept a string of numbers (separated from the command name by a space 
and from each other by commas) that are used to specify the justification margins. These values 
will then replace the default values and will apply to all subsequent filling and justifying commands. 
Normally 4 such values arc specified, these being the indentation of the first line of each paragraph 
(Crown margin), the indentation of all subsequent lines (Left margin), the maximum length of the 
line including the indentation (Right margin) and the number of blank lines desired between 
paragraphs (Blanklincs margin, where positive numbers refer to the number of blank lines and —1 
specifies that the actual number of blank lines used in the original text are to be preserved). Only 
the values that are to be changed need be specified but commas must be typed to indicate any 
missing values that precede the values that are typed. The initial default values for these margins 
are 0,0,74,-1 (C,L,R,B). 

Paragraphs are normally detected in the input text by (1) an empty line or (2) a line with exactly 
the specified Crown indentation. Under some circumstances it may be necessary to set the Dctect- 
Paragraph margin to a different value from the desired new Crown indent. This can be done by 
typing the desired value followed by a slash at the start of the margin specifying string. See e.als 
for full details. 

It is possible to use the ®Xjgft<cr> command, as described below, causing E to get the margin 
values from in-core paragraphs. 

®Xjfifl<cr> Adjust the length the text lines to be equal to or less than the currently 

specified value by moving words from line to line within the individual paragraphs, fixing 
the left margins to the currently specified value. 

<8>Xjust<CR> Adjust the line lengths as with ®Xjfill<CR>, but then pad the lines by 

distributing additional spaces between the words so as to align the right margins. 

®Xjfill 4,0,66,0<CR> Reset the margin values before executing the command as defined above. 
The Crown margin will be 4, the Left margin will be 0, the Right margin will be 66 and 
dierc will be no blank lines between paragraphs. 

®Xjfii.l 4/0,4,66,0<cr> Reset the margin values before executing the command. This is the form 
that die command would have to take if one wished to reverse the Crown and Left margin 
values for text that had previously been ®XjFlLLcd with the command listed above. 

®4®Xjfill<cr> Adjust the length of the next 4 text lines (the count applies to the lines as 

they arc initially) starting with the arrow linf. 

®4a/?!®XJFiu.<CR> Starting with the arrow linf, apply the command to 4 paragraphs. Note 
diat the rest of the paragraph containing the arrow fine counts as the first paragraph. If 
the ! is used without an argument, it is taken to mean one paragraph. Sec section 8.5 
below for more details on the paragraph designating symbol !. 

®4a!®XjFlLL<CR> As above, but starting at the beginning of the paragraph containing the arrow. 

®0®Xjfiff<cr> Report the current margins without any overt action other than to record the 
typed changes to these values that may accompany the command (and that are recorded 
before the report is made). The astute user can reacquaint himself with the details of the 
way in which these values arc assigned by using this and the following command. 

®#®X.igft<CR> Scan the specified number of text lines to determine the indent values for the 
first and subsequent lines in each paragraph and the column position of the rightmost 
character. Store dicsc for use with subsequent commands. This command is handy if die 
user has already typed one or more paragraphs in the desired format (perhaps in an earlier 
editing session) and wishes to set the justification parameters to these former values. 

®Xsjfifkcr> Separate the sentences in the specified text so that they all start on separate 

lines. This is useful whenever it becomes desirable to rearrange the sentences within a 
paragraph or to move sentences between paragraphs. 
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8.4 Aligning, Indenting and Centering Commands 

These commands preserve the identity of the text lines and insert or delete leading spaces and tabs 
as required. In contrast with the justifying commands, these commands default to operate on a 
single line (the ARROW line). A prefixed decimal argument or the use of the ATTACH buffer may 
be used to extend their range of application. If the text contains interior tabs, these are converted 
to spaces before the move, so that the absolute size of the spacings are preserved. An option exists, 
as demonstrated below, for changing the default condition so as to preserve interior tabs. When 
possible, initial tabs arc used to save disk storage space. A zero preceding argument will cause the 
existing default values to be displayed.. 

<8>Xai.ign<CR> Align the ARROW line (or the entire attach buffer), moving the line or lines 

so diat they start with the default align indentation (originally set to 0). 

<8>8<8>Xalign 3<cr> Align 8 lines starting with the arrow line and indent them by 3 spaces. 

®8®Xalign T 3<CR> As above, but preserve interior tabs. Note that the T argument is sticky. 

The default condition can be restored by using the letter S instead of T. 
0-* Move the arrow line to the right by the (absolute) default-indent value (initially at 4). 

<8>5®-» Move 5 lines starting with die arrow line to the right by the default amount. 

<8>*- Move the arrow line to the left by the (absolute) default value. The movement is 

limited by die first non-blank character in the line. 

<8>Xindent 8<CR> Set the default indent value to 8 and move the arrow line (or the entire 
attach buffer) to the right by 8 spaces. Note that the <8>-> and die <S)*- 
commands still move the text in the indicated direction even when this 
command has been used to set the default to a negative value.. 

<S>Xcenter<CR> Center the arrow line between the left and right margins as defined by the 
current justification margins. 

8.5 Formatting Tabular Material 

Formatting tabular material is dificult if (1) the initial material is improperly aligned in columns or 
(2) if there are missing entries. F, provides facilities for handling two distinct types of tabular 
material. In the first type, there can be no missing entries but the material need not be properly 
aligned into columns as long as the different entries are separated from each other by at least 2 
spaces or by tabs (and, of course, the entries themselves must not contain double spaces or tabs), 
and die input material may contain some associated text (perhaps a comment field) that is to be 
justified or jfilled. In the second type, the original material must be aligned in columns but there 
can be missing entries. 

Table- formatting commands require the specification of additional values beyond the C,L,R,B values 
specified with the normal-text-formatting commands. When these are typed they must start with a 
semicolon and they are separated by commas. Values not otherwise marked are for field lengths, 
with the first field assumed to start at the Left margin. For example, ;5,8.9<CR> means that the first 
field occupies 5 character positions, the second occupies 8 positions and the third occupies 9 
positions. For more details sec e.ai.s. A command <8>Xtget<cr>, analogous to <S>Xjget<CR> is 
available for establishing the initial conditions from a line in the tabic that docs not have missing 
entries. 

For details concerning the <8>Xtable<cr> command for material already aligned in columns and the 
®Xt.il'ST<cr> and ®Xtji-ii.l<cr> commands for misaligned tabular material, see E.ALS. 
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9. Some Additional Commands 

8.1 Line Deleting and Undeleting Commands 

afiD Delete the arrow line. 

<8>4a)3D Delete 4 lines starting with the ARROW LINE. 

<8>Xcancel<cr> Restore the in-core copy of the current page from the disk, thus cancelling all 
changes made since the last disk-save command. 

®Xundei.eie<CR> Restore to the beginning of the aitacii buffer the last group of lines altered or 
deleted by a single command. Note that any lines changed by the last-executed line- 
changing command may be restored by this command. 

®#®Xunoellte<cr> Restore the last # number of lines whether or not these were all 
altered or deleted by a single command. 

<8>0<8>Xundi:lete<CR> Report the number of lines that are available to undelete. 

See E.ALS[UP,DOC] for more details. 

9.2 Switching to a File Named on the Page Being Edited 

®Xl'OiNTER<CR> Switch to the first file named in the text being edited at or below the arrow 
line. See e.alS[up.D0C] for details as to how the file name must be formatted 
to be recognized by this command. 

9.3 Conserving File Space 

®XsiN<CR> Put spaces in place of tabs on the current page or the attach buffer. This will, of 
course, increase the space occupied by the text but it may be necessary to preserve 
spacings if extra characters are to be added ahead of the tabs. This command should 
be followed by the <8>Xtin<CR> command and uhen the <8>Xburp<CR> command as 
soon as possible. 

<8>Xtin<cr> Replace spaces by tabs where this will reduce the space occupied by the text. This 
command also deletes trailing spaces and tabs from all lines. Note that this extra space 
is all collected as all-null records at the end of the page and that the ®Xp>URP<CR> 
command is still needed to save this space on the disk. 

®Xburp<CR> Write out the current page and in the process reduce the disk space for the page by 
deleting any all-null records from the page. 

®e/oop<cR> Burp the entire current file, not just the current page. 

9.4 Generating a New Directory Line 

®Xndfail<CR> Generate a New Directory line for the current page for a fail- or MACRO-type 
source file. 

®Xndsaikcr> Generate a New Directory line for the current page for a SA 1 1. -type source file. 
This command can be modified for use with pascal or any similiar language by 
replacing or adding to the list of category words that arc used to signal the inclusion of 
the word that follows the category word. Sonic minor hand editing may be required. 
Sec e.ai S[UP.00C] for details. 

9.5 Message and Paragraph Designating Commands 

The partial character 3 on the DataDisc keyboard and the explanation point !, when used with ®, 
refer to a message and a paragraph, respectively. A message is defined as a contiguous set of lines 
(sonic of them may be blank) which starts with a 3 and which is followed either by a line 
beginning with another 3 or the end of the page. A paragraph is similarly defined as a contiguous 
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set dI' non-empty lines plus a single preceding empty line, if one exists, and all but one of any 
following empty lines (actually all of the following empty lines if there are no more non-blank lines 
on the page). 

These two prefixes, by themselves, usually do not initiate any action but they do define die range of 
action of the command that follows. The one exception in which the 3 or ! initiates an action 
without wailing for a following command is when it is preceded by a argument (that is ®<)®3 
ami ®()®!). For these cases the command immediately moves the arrow to the beginning of the 
current message or paragraph. 

Typing the 3 or ! with <fONIROL> only, defines the message or paragraph as starting at the 
beginning of the current message or paragraph even if the arrow is not at the beginning. Typing 
the 3 or ! with both <CONTROL> and <vikta> defines the range of action as starting at the ARROW 
LINK. 

The 3 command has an added property not possessed by the ! command. Ibis properly is that it 
will cause the deletion of an entire page (including a page mark) if the command is to delete or 
attach an entire message and iff the message is the only message on the page and there are other 
pages in the file. 'I 'he next page (if there is one) or (if not) the preceding page will be brought into 
core. 

Some typical commands are: 

®0«3 Move the arrow to the beginning of the current message. 

a3® A Attach the current message (at the end of the attach buffer if there is already something 
attached). 

<8>-a3<8>A Attach ihc previous message (at the beginning of the attach buffer ahead of 
material that may already be attached). 

®3a3a/?D Delete 3 messages beginning with the current one (slopping if the last message on 
the page has been deleted). 

<g> -<g>oo a 3a/?D Delete all messages in the in-core pages that preceed the current one. 

<8>!a/kCR> Kntcr the link inskrt mode between the current paragraph and the next one. 

a!<8>XJUSi<CR> Justify the current paragraph. 

«/?!<8>X.luST<CR> Justify the rest of the current paragraph starting with the ARROW LINK. 

9.6 Parenthesis and Bracket Finding and Matching Commands 

Several commands arc available for finding and matching parentheses, both of the conventional 
sorts and using any desired set of (single) characters, as defined by the user. The default set is, of 
course ( and ) . Some users find it convenient to use the set C and D to mean begin and end 
while writing programs so that the parenthesis matching commands may be used to keep track of 
nesting levels, and then substitute begin and end for these only when required to do so by the 
limitations of the compiler (plug: the SAM compiler does not suffer from such a limitation). 

Some useful commands are: 

<8>( Kind the next left symbol of cither the default variety or as defined by a previous 
<8>Xi>arkn command (sec below), limiting the search to the in-core pagc(s). If the 
CURSOR is already at a left symbol this command is a no-op. The convention is that when 
the cursor is under a left symbol, it refers to the condition just to the left of this symbol. 
Similarly, when the CURSOR is under a right symbol, it refers to the condition just to the 
right of this symbol. 
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<8>4<8>( Move the CURSOR to that left symbol that would cause the nesting level to reach 4, 

considering the present nesting level to be 0. Do not move the CURSOR if this level is 
never reached. 

®4®Xlparen<CR> Similar to the above except that the search is not limited to the in-core 
page(s). 

<8>) If the cursor is under a left symbol, move the cursor to the matching right symbol if it 
can be found on the in-core pagc(s). If the cursor is not under a left symbol, then search 
for the right symbol that returnes the nesting level to its current value. Note diat this 
command is a NO-OP only when the desired level cannot be reached. If the end of the text 
is reached before a transition to the current level is found, the cursor is left in its original 
position and the deficiency is reported. Deficiencies may be of two sorts, either a left 
symbol is never reached, or a right symbol may never have been encountered while at the 
next nesting level. 

<g>3<8>) As above but search for the right symbol that reduces the level from the specified nesting 
level, in this case from level 3 to level 2 (considering the current level to be 0). 

<8>3®Xrparen<cr> As above but not limiting the search to the in-core page(s). 

®** Undo the last parenthesis matching command and return the CURSOR to its former position. 
This allows one to look back and forth between the two matching symbols. 

®Xparen {<CR> Define the parentheses to be the symbols { and }. Note that a single space 
must separate the character from pa REN and only the left symbol of the set need be typed 
to select a set from the following list of character pairs: 
() ->«- CD " {} <> []. 

®Xparen A7.<CR> Define the parentheses to be "A" and "z" (any pair of characters may be used). 
A distinction is made between upper and lower case letters. Note that both letters must be 
typed and that no extra spaces can be used (a space is a valid parenthesis!). Obviously, the 
scheme will not work if the chosen characters are used for other purposes in the text. 

®Xpinfo<CR> Type out information about the last parendiesis search. 

9.7 Lisp Indenting Commands 

E has limited ability to parse LISP S-expressions and to indent lines accordingly (with tabs and 
spaces as needed). Text is never moved from one line to another. Super-brackets are recognized, 
making ] in the text close back to the matching [ or close all hanging ('s if no hanging [ is present 
to match. Except for this difference, the parsing is by MacLisp character set interpretation using a 
table of 128 entries that can be modified by the <8>Xuspsyntax command (see EATS for details). 
The principal commands of interest are: 

a/ Lisp indent the current line by context above it. 

afi/ Lisp indent the next line by context above it or the first attached line in context of the 

page. 
a#a/ Lisp indent # lines starting wilh the arrow line. 
®#aft/ Lisp indent tt lines starting wilh the next line or with the first line in the attach buffer 

in context of the page. 

9.8 Issuing System Commands from E 

There arc a number of system commands that can be issued while in K. Some of the more 
important commands of this type are: 

®Xai.ias <project>,<programmcr><CR> Change alias just as by the equivalent system command. 
®XPROl'i:ci'lON'<C'R> Type out the protection key for the tile being edited. 
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0XPROTECTION nnn<CR> Change the protection for the file being edited to the octal value nnn. 

®X\VRITTEN<CR> Type the date and time when the present file was previously written and 

the PPN and jobname of the person who did it.. 

®Xmail destination and switchcs><CR> Execute a system MAIL command using the text 

from the current page or attach buffer. 

<8>0<8>Xmail <dcstination><spaceXone line of text><CR> Execute a system mail command, timiting 
the message to the one line of text that is typed between a space following the destination 
and the terminating <CR>, that is with no text from the page or attach buffer. 

0XSKND destination and switches><CR> Execute a system SEND command using the text 

from the current page or the attach buffer.. 

<8>0<8>Xsend destination XspaceXone line of tcxt><CR> Execute a system SEND command, limiting 
the message to the one line of text that is typed between a space following the destination 
and the terminating <CR>. 

®Xremind destination and switches><CR> Execute a system remind command. 

<8>Xdfind <tcxt><CR> Start a find program as another job and report results. For detailed 
information on the find program see l ind.don[UP,doc]. 

®Xspool<CR> Spool the contents of the current page or of the attach buffer. 

<8>Xxspool<CR> XGP spool the contents of the current page or of the attach buffer. 
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10. Macro Commands 

Macros are provided in E to save the user the effort of retyping strings of commands that are 
needed frequently. A Macro represents any number of characters that will be given to E as 
commands and text (in lieu of this material being retyped) whenever the Macro is called by name 
or by a simple repeat command. A Macro may call other Macros or even itself (with nesting to a 
certain maximum depth), it may contain conditional branching and it may be called with repeat 
arguments. In fact, it is possible to write Macros that are, in effect, complete computer programs 
that will make major modifications to the file being edited. 

All standard E commands (including line editor commands) may be used within Macros. There 
is one very important restriction: if a aD or a I in a Macro is intended to be given at the end of a 
line, it must be preceded by a a<TAB> or a aK<CR>. 

Macros may be defined and used during a single editing session and they may be written into a 
command file and saved for future use. Many users find it convenient to develop a series of 
Macros that serve their particular needs and to save them in a file in their own disk area under the 
name of einit.cmd. The contents of this file can then be loaded into the user's core area when 
needed during an editing session and they will then be available for repeated use. The file 
einit.CMD[U] contains several commonly used public Macros. An easy way to become familiar with 
the many intricate details of Macros is to copy one of these Macros and gradually modify it to meet 
one's particular needs. 

Most users of E make but little use of Macros. While the subject is much too complex for adequate 
coverage in the present manual, an attempt will be made to show the value of the Macros and 
perhaps help new users to start using these commands. As a start, the user is urged to define a 
simple Macro, as explained in Section 9.1 below, and then to execute the Macro on a test program, 
using the commands listed in Section 9.2. Having done this, the next step might be to execute a 
Macro-defining command from the file einit.CMD[1,3], as explained in Section 9.3. 

10.1 Defining Macros Directly 

Macros may be defined with the command 

<8>Xdefine <Macro namc><CR>. 
The name may contain letters or digits (with only the first six characters being significant), it may 
be blank, or it can consist of exactly one of the following 9 characters: 

= DUCD$%~_ 

which appear on top of the digit keys on the DataDisc terminals. On receipt of this command, E 
asks the user to type the commands (and text strings, if any) that the Macro is to represent, ending 
with a/Kl.lNE>. The commands must be typed in exactly the same way that they would be typed 
were they being given for immediate execution. When the a/?<i ine> termination is typed, E will 
display the Macro name and its definition in terms of a. standard notation (as given in the tabic in 
Section 9.6 below). The user. of a DataMcdia terminal may find the list in the Appendix useful to 
show him how these symbols will appear on the DataMcdia screen. 

Macros that are defined in this way are kept in the user's core area and they may be called for 
execution, as required, at any time during the same editing session. As explained below, Macros 
may be stored in a file for future use or they may loaded into the Al'lACil buffer and then placed 
into the file that is currently being edited where they may be edited in the normal way before being 
again made available for execution or storage. Useful defining commands are: 

0XOEFINI-: <Macro name><CR> Accept the following string of commands and text as a Macro 
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under the name specified in accordance with the above explanation. 

®0®Xdefine<cr> Type out the names of all defined Macros. 

®0®Z<Macro name><CR> Type out the named Macro without executing it. 

<8>0<8>Y Type out the Macro that would be executed by the <8>Y command as defined 
in section 9.2 below. 

<8>XSET <newname>*-<oldname><CR> Copy the definition of Macro oldname into the definition 
of a new Macro ncwname. 

0XSET <newname><-<CR> Copy the definition of a Macro that was typed with a blank name 
into the definition of a new Macro newname. 

10.2 Calling Macros for Execution 

Macros are called for execution by one of the following commands. 

®Z<Macro name><CR> Execute the named Macro once. 

<8>3<8>Z<macro name><CR> Execute the named Macro 3 times. 

®fl Execute the special single-character Macro named "D". 

®8<8>n Execute the special single-character Macro named "D" 8 times. 

®Y Execute the last executed Macro or the last defined Macro if one has just been 

defined (but not considering any special single-character-named Macros). 
®6<8>Y Repeat the execution 6 times of the last executed named Macro or the last defined 

Macro. Note that the symbol oo ma y be used for the number of executions if the 

Macro contains internal provisions for its termination. 

10.3 Executing Commands and Defining Macros from a File 

Commands stored in a file may be called for execution by the ®Xexeclte command, as described 
below. It has become common practice to write Macro files as a series of ®XDEFlNE<macro 
name><CR> commands, each followed by the command list that is being defined and a <8>Xsay 
<macro name><CR> command (this command simply causes the macro name to be typed out). 
When such a file is called by the <8>XExncLTE command, it is the ®Xdi:fine and ®XSAY 
commands that arc executed. The defined Macro or Macros are simply defined (that is, loaded) 
into the user's core area without being executed and the user is given the names of the Macros so 
loaded. The user may then cajl the individual Macros for subsequent execution, as needed, using 
the commands listed in section 9.2. 

®Xexecute <file name> «page range>)<CR> Read the selected pages from the named file into a 
temporary Macro and then execute this Macro. If no file name is given, the default file 
will be used (initially EINIT.CMD on the user's log-in area). If no page range is given, 
the entire file is used. 

<8>0®Xr:XECLTE<CR> Type out the current default execute file name. 

10.4 Writing Macros into a CMD File 

The command 

®Xpltdei-'S <filc name><CR> 
writes all of the Macro definitions that currently exist in the user's core area into the named (lie or 
into a default flic, if no name is given. This default file will be the last file referenced by a 
<8>Xpltdi-I'S<CR> or a ®Xi:xiCLii:<CR> command, or if none lias been referenced it will be the file 
eimt.cmd on the users log-in file area. If the file chosen already exists, the newly stored Macros 
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will be added to the file as a new page. If the file docs not exist, one will be created. The Macros 
will be in the standard representation as listed in the left column of the table in section 9.6 below. 
Please note that these representations are not to be used when defining Macros with the Xdefine 
command, although either of the two representations (or a mixture of the two) may be used if one 
writes or edits a Macro file for subsequent execution as described below. 

10.5 Writing Macro Command Files Directly 

Most, users prefer to write complicated Macros as one would write any normal computer program, 
of course, using E as the editor. The alternate notation, as listed in section 9.6, simplifies this task, 
particularly for users of DataMedia terminals. A Macro file that is created in this way may contain 
a directory page (which will be ignored) and it may contain comments. 

In command files, the character a is used to indicate that the CONTROL bit is to be added to the 
next command, and the character /? that the META bit is to be added, quite analogous to the way 
these characters are used in this manual. However, the character <8> cannot be used to mean either 
a or a/?. Instead, it is used as an escape character to signify that the next character has a special 
meaning as shown in the following table. Note that the symbol <8> in a Macro must always be 
followed by one of the characters listed in the table. This is a situation where the a, /? and ® 
symbols arc actually typed into the text when one writes the commands, in contrast with the 
situation where one is typing a Macro in directly, where the indicated <CONTROL> and <META> keys 
are used. 



Extra spaces cannot be inserted into the command-file text for formatting as they will be taken to 
be part of the defined Macro. Tabs in the command- file text (as distinct from ®= or ®T) are 
ignored, however, and they may be used freely to separate commands or to set off comments from 
commands. Carriage returns and line feeds (not the commands ®+* etc.) also are ignored, allowing 
the text to appear on multiple lines for legibility. 

10.6 Notation used in CMD files and in Typing Them 



Representations 
Standard Alternate 



<8> = 


<8>T 


<g>* 


®A 


<g>*± 


<8>C 


<g»<- 


<8>V 


<g>-> 


®F 


®i 


®L 


®t 


®B 


®a 


<8>X 


<8>/? 


<8>Y 


<g>® 


®<g> 


<8>; 


<g>; 


<g>C 


®C 


a 


®1 


fi 


<8>2 



Command as accepted by E 

<tab> horizontal tab 

<alt> altmode 

<CR> carriage return 

<vt> vertical tab 

<FORM> form feed 

<line> line feed 

<BS> backspace 

an a is wanted in the text 

a p is wanted in the text 

a ® is wanted in the text 

Ignore text from here to the end of the line (for comments) 

Ignore text from here to the next D (for long comments) 

Add <CONTROI> bit to next command 

Add <Mi:i'A> bit to the next command 



example: aF means the command <CON TROL>F 
while a®F means the command <contro[.xform> 
and a®-> means the command <CON'i rofxformx 
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10.7 Editing and Redefining Macros 

It is often necessary to modify Macros, cither to correct them or to adapt them for use in a slightly 
different situation. This can be done by using the following commands. 

®Xattach <Macro name><CR> Put the named Macro into the attach buffer (which must be 
empty at the time this command is given). The attachment may then be deposited in 
the current file for editing in the normal way. 

®Xredefine <Macro name><CR> Use the contents of the attach buffer to redefine the named 
Macro. 

10.8 Terminating and Resuming Macro Expansion 

There are several commands available to the user to interrupt a Macro expansion. Only one of 
these is important enough to be reported here. For the others see e.als. 

<ESC>I Terminate the Macro expansion (either because it is doing the wrong thing or because 

you want to inspect what it • is doing). 
®Xresume<CR> Resume the Macro expansion at the point where it was terminated. 

10.9 Special Macro Commands 

A full explanation of the many special commands available for use in Macros is beyond the scope 
of the present manual. It may be of interest, however, to list some of these so that the reader will 
have some idea as to what is available and will be better able to find wanted information in E.ALS. 

The following commands are used to stop macro expansion in the event of an error and allow for 
the selective aborting of Macros that may have been called by other Macros 

®XSTOPALL<CR> ®XSTOPONE<CR> ®XSTOPZERO<CR> 

with ®Xstophow<cr> being available to request a report as to which of the three is in effect. 

The number-sign command in a Macro, ®# (where # is actually used in this case and does not 
mean some specific number, as it is used elsewhere in this manual) allows commands inside of a 
Macro to access and use the repeat argument given with the macro call. 

The following commands may be used in macros and accept either a read-only-variable name or a 
macro name: 

®XlFLT ®XlFLE ®XlFGE ®XlFGT ®XlFEQ ®XlFNE 

®XADD ®Xsubtract ®XMAXIMUM ®Xminimum ®XMULTIPLY ®Xdivide 

®Xremainder ®Xargument ®0®Z. 

The read-only variables available all end with a period and their names can not be abbreviated. 
Some typical ones are: 



LINE. 


FINES. 


PAGE. 


PAGES. 


COL. 


COLS. 


COUNT. 


CHAR. 


CHARS. 


CORIIN. 


COR INS. 


CORCIIS. 


ASCII. 


SIXBIT. 


CMAR. 


IJVIAR. 


r.mar. 


IJNUM. 


NJTND. 


NFOUND. 


NSUBST. 









The commands, ®Xstep <macronamc><CR>. ®&, and ®Xautostfp<C'R> simplify debugging and 
allow the user to step through the execution of a Macro while seeing the results of each command. 
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Appendix A 

Missing and Equivalent DataMedia Keys 

Most of the missing keys on the DataMedia can be typed by holding the CTRL key and typing the 
character shown in the following table. Three characters require the use of 2 separate key stokes. 
Caution: do not confuse the a, )3 and <8>, as shown in this table, with these symbols as employed in 
this manual to mean the use of control keys. 



To 
Get 

I 


Hold and Type then Type 
<CTRL> a 


Appears Brightened 
on Screen 
a 


a 

A 


<CTRL> 
<CTRL> 


b 

<NUL> 

d 


<CALL> 


b 
c 
d 


—i 


<CTRL> 


e 




e 


£ 


<CTRL> 


f 




f 


IT 
X 


<CTRL> 
<CTRL> 


g 
h 




g 
h 


<VT> 

<FORM> 

CO 


<CTRL> 
<CTRL> 
<CTRL> 


k 

1 (or tL key only) 

n 


k 

1 
n 


a 


<CTRL> 










c 

D 


<CTRL> 
<CTRL> 


P 

q 




P 

q 


n 


<CTRL> 


r 




r 


u 


<CTRL> 


s 




s 


V 


<CTRL> 


t 




t 


3 


<CTRL> 


u 




u 


® 


<CTRL> 


V 




V 


*± 


<CTRL> 


w 




w 




<crRL> 


X 




X 


-> 


<CTRL> 


y 




y 


< 
> 


<CTRL> 
<CTRL> 
<CTRL> 


z 

\ 

] 

<NUL> 


<CLEAR> 


z 

A 

1 


V 




<NUL> 


<HOLD> 




<ALT> 




<ESC> 






<BREAK> 




<NUL> 


— (minus 


sign) 


<BS> 




<DEL> 






<CLEAR> 




<MR> 






<F.SC> 




<NUL> 







30 



Appendix B 

File Switches 

When entering a file, the user may request a number of options as expressed by switches. These 
switches consist of a slash ( / ), then an optional decimal number, then a single letter. Any number 
of switches may follow the file name. Should a conflict arise between switches, the later switch 
overrides the earlier one. Only a few of the possible switches will be described. For others see 

E.ALS[UP,DOC]. 

/C Create a new file with the specified name. This is equivalent to the use of CET, as noted 
above. It can be used if one discovers that the C in CET was forgotten and one has just 
finished typing the file name. It may also be needed when switching files using the 
commands listed in section 3.1. 

/F Repage and reformat the file, limiting the maximum number of lines per page to the 

default value of 33. Existing page marks are retained so some pages may be shorter than 
the specified value. Reformatting causes the file to be rewritten on the disk with a possible 
saving in space by removing unnecessary null records at the end of each page. 

/66F Repage and reformat the file, limiting the maximum page size to 66 lines. 

/OOF The infinity sign may be used as a number. This switch docs not introduce any extra page 
marks but it docs remove any unnecessary null records, as noted above. 

/Q Quietly assume a yes answer to any question E might otherwise ask as to the need for 
reformatting, replacing an existing file, or discarding an invalid directory. Use this sv/itch 
with caution: for example, the command CF.T foo/Q<CR> will delete an entire file FOO, if it 
exists, and replace it with an empty file! Without die /Q switch, the user would be asked 
to verify the command before it would be executed. 

/N Edit the file without writing a directory on page 1. When, this switch is used, E will create 
a new directory (on page 0) each time the file is called into core. The preferred way to use 
F. is to allow a directory to be created on page 1 and to copy the file later omitting page 1, 
if necessary. 

/F/R Repage and reformat the core version only, without changing the disk copy. This is useful 
for examining an unformatted file with huge pages that has been produced by a program 
other than E. 

/D Search the system documentation disk areas for the partially named file and open in read- 
only mode the first possible file that is found. This same effect is produced by the monitor 
command read, when used in place of Fr. This command is of use when one is in doubt 
as to the exact name of some desired documentation file. 

/33P/47L Open the specified file on page 33 with the arrow at line 47. If no page is specified, 
the first page (the directory) is assumed (or the text page, if there is only one), and if no 
line is specified, the first line is assumed. 
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